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Prometheus 
Gain insights into your N+ Ingress Controller 
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NGINX Plus and the Ingress Controller 
NGINX Plus API 

Prometheus, Prometheus Exporter, Grafana 
Demo 
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NGINX Plus, Kubernetes, 
Prometheus and Grafana 


SOO 
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K8s and NGINX Plus 


e Ingress Controller available in 
NGINX Inc. Github repo 


e SSL Termination, Path based 
routing, rewrites, websockets 


e Also exposes NGINX Plus 
functionality 


o Status API, Session Persistence, JWT 
Auth, On-the-fly reconfig 


Annotations for extending 
functionality 


https://github.com/nginxinc/kubernetes-ingress 
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NGINX Plus API 


e Over 150 metrics 
HTTP and Stream 
Server blocks 
Upstreams 

Cache Instrumentation 
Memory zone utilization 


e Read/Write(able) 


O 
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http://nginx.org/en/docs/http/ngx_http_api_module.html 
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NGiNX+ 
U 
nginx-plus-r16 (1.15.2) Connections SSL 
Address 192.168.94.87 
Curren t Accepted/: Acti 
PID 11 9 2 3 7 3 


Uptime‘: 10d/18h 38m, 


Server zones O Upstreams O 


Total Problems Total Problems 


Prometheus Metrics 


. 
e k to re S TI m e b a se d € C © Not Secure | 192.168.94.88:30001/graph?g0.range_input=30m&g0.expr=rate(nginxplus_connections_active%7Bapp%3D"nginx-ingress"%70%5B5M%5D)& 


. 
O Enable query history 
7 E Load time: 22ms 
rate(nginxplus..connections.activefapp="nginx-ingress"}[5m]) Resolution: 7s 
Total time series: 2 
SCENE - insert metric at cursor- + 


Graph | Console 


e Easy to query, filter ar mn 
and extract 


0.04 


0.03 ZA 


e Scrapes data from 
instances 


0.02 


g g g nginx-ingress",controller_revision_hash="1698869572",instance: "kubemetes-pods",kubemnetes_namespace="nginx-ingress” kubernetes_pod_name="nginx-ingress-bh7f6",pod_template_generatior 


iginx-ingress",controller_revision_hash="1698869572" instance="192. 168.94.87:9113" job="kubernetes-pods”,kubernetes_namespace="nginx-ingress",kubernetes,_pod_name="nginx-ingress-67nh7",pod_template_generati 


https://prometheus.io/ 
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Converts the API status into 
Prometheus consumable data 


Written in GO 


Exposes metrics such as: 
Status codes 

o Connection counts 
Upstreams status 
Server zone status 


Automatic discovery with 
Prometheus Annotations 


[root@k8s-1 -]# curl http://192.168.94.88:9113/metrics 

# HELP nginxplus connections accepted Accepted client connections 
# TYPE nginxplus connections accepted counter 

nginxplus connections accepted 275687 

# HELP nginxplus_connections active Active client connections 

# TYPE nginxplus connections active gauge 

nginxplus connections active 1 

# HELP nginxplus connections dropped Dropped client connections 
# TYPE nginxplus connections dropped counter 
nginxplus_connections dropped O 

# HELP nginxplus connections idle Idle client connections 

# TYPE nginxplus_connections_idle gauge 
nginxplus_connections_ idle 6 

# HELP nginxplus http requests current Current http requests 

# TYPE nginxplus_http_requests_current gauge 
nginxplus_http_requests_current 1 


Powerful WebUl for data 
accessing and visualizing 
datasources 


Customize dashboards for 
meaningful reports 


° Report on NGINX uptime, 
health, throughput etc. 


bittne://nrafana nnm/ 
nttps:// gratana.com/ > 
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Thank you 


brian.gautreau@nginx.com 


